home *** CD-ROM | disk | FTP | other *** search
/ Turnbull China Bikeride / Turnbull China Bikeride - Disc 1.iso / ARGONET / PD / PROGRAMMING / FORMEDEXT.ZIP / !FormEdExt / !Help < prev    next >
Text File  |  1996-11-09  |  9KB  |  208 lines
  1.                                FormEdExt
  2.                                =========
  3.                                 
  4. Version 1.58 (01 Sep 1996)
  5.  
  6. Introduction
  7. ------------
  8. FormEd was Acorn's first 'attempt' at a template editor, in the /very/ dim
  9. and distant past. Since then, many people have played around with the basic
  10. versions they got hold of to 'improve' them to a usable standard. Thus, many
  11. FormEd's appeared in PD libraries purporting to be the be all and end all of
  12. template editors.
  13.  
  14. This is another of those hacks :-)
  15.  
  16. Whilst it doesn't do all the snazzy things that ResEd does, and probably
  17. doesn't reach the heights of TemplEd or Glazier, it is *my* hack and I like
  18. it.
  19.  
  20. Why should you use it ? I dunno... Look at it, see what you think and tell me.
  21. What features has it got ? Hmm... good question... let me think :
  22.  • Create Icon submenu to allow you to create 'standard' icons much more
  23.    easily. These come in 7 flavours :
  24.     + Text Entry icons
  25.     + Button icons (OK, Normal action, old dialogue buttons, and a submenu
  26.       button)
  27.     + Group icons (Raised, Sunk with a bordered title, and sunk without a
  28.       bordered title)
  29.     + Radio icons
  30.     + Toggle icons
  31.     + Info & menu icons (like in !Printers)
  32.     + Sunk data icon
  33.     + Load icon (for dragging files to)
  34.  • Amend icon vastly modified.
  35.     + Text changes will extend into indirection if required
  36.     + Sprite changes reflected in the indirection string
  37.     + Border submenu allows you to select from the 7 standard border types,
  38.       plus toggle colours for Button and Default types
  39.     + Indirection now allows options of :
  40.       . Keys to allow (or disallow)
  41.       . Pointer type to change to (including hotspots)
  42.       . Protected entries (setable character)
  43.       . Key press options
  44.       . Long text
  45.     + Colour selection is reflected in the indirection string if fonts are
  46.       used.
  47.   • Move icon now allows greater control :
  48.     + Absolute position may be specified
  49.     + Width and height may be specified
  50.     + The icon can be shrunk to it's minimum size possible
  51.   • Linking (only partially supported)
  52.     + Icons may have their top left corner locked to an arbitary corner of
  53.       another icon (I think that's how it works).
  54.     + List of the linked icons by Shift clicking the Amend icon entry
  55.     + Move/copy can be performed on a group
  56.   • Window flags now include the keep on screen, Ignore X and Ignore Y flags.
  57.   • Work area now allows you to specify that the window will not go smaller
  58.     than the title bar.
  59.   • Browser window now shows which icons are manually redrawn.
  60.   • Templates are now much prettier (use borders and buttons).
  61.   • Supports (tentatively) the Interface and WimpExtension modules
  62.   • Supports External Edit sessions as an Editor.
  63.  
  64.  
  65. Usage (with care)
  66. -----
  67. Double clicking a template file should load it into FormEdExt, and will
  68. display the main browser box.
  69.  
  70. The browser box
  71. ===============
  72. Yellow icons don't have scroll bars of any kind.
  73. White icons (with the bars down the side) do have scroll bars.
  74. Any icon with crosses on it is redrawn by the program and not completely by
  75. the WIMP.
  76.  
  77. Double clicking any of these will allow you to edit it's definition.
  78. Clicking Menu will allow you to save the templates, copy or rename single
  79. windows or delete one or many, or to create a new window.
  80. Select and Adjust clicks allows you to change the current selection.
  81.  
  82. Windows
  83. =======
  84. Once a window is open, you can edit an individual icon (or the window) by
  85. clicking Menu over an icon.
  86. Creating icons is done by clicking menu in approximately where you want the
  87. icon, and selecting Create icon (or a sub-menu option).
  88. Editing icons is achieved by the Amend sub-menu. This is really too much for
  89. me to go into detail about at this time of night (4:40 am)
  90. Renumbering, Copying and Moving should be pretty self explanatory.
  91. Linking is only possible if the icon is indirected, and should be used with
  92. EXTREME care.
  93. Guess what Delete does.
  94.  
  95. The Window flags are again too lengthy to go into right now. Catch me some
  96. time when I'm not busy or when I ask for any ideas for PD programs.
  97. Colours allows you to change the window and border colours.
  98. The Workarea box allows you to change the size of the windows ACTUAL extent
  99. (ie that which you could see if it were full size). The actual positions of
  100. the corners are given for the full extent, whilst the minimum extend applies
  101. to the visible size of the window. The Min title button will ensure that the
  102. window never gets smaller than the length of the title bar text.
  103. The identifier just tells you what the window is called, and cannot be edited.
  104. And finally Close window will do just that (not delete it - do that from the
  105. browser).
  106.  
  107. Other things
  108. ============
  109. Dragging an icon with Select will move it, if (and only if) you have set the
  110. button type to allow such drags. Dragging Adjust will resize the nearest
  111. corner, but again only if the button type allows it. To get around this, you
  112. may use Alt-Select/Adjust drags to force icons to move/resize.
  113.  
  114. This can, however, cause problems. If you have my TextCopy installed, then
  115. trying to drag a writable icon with Alt held down will try to copy the text
  116. out of it (ie it will ignore Alt completely), so you will have to hold down
  117. Ctrl-Alt, or just Ctrl if you have AllWCD installed as well. The former of
  118. these can cause problems if you have one of the PD screen grabbers which
  119. grabs screens when you press Ctrl and Alt together (I do). Solution: Use the
  120. Other Ctrl and/or Alt keys - it works on mine.
  121.  
  122.  
  123. How it works
  124. ------------
  125. Ask Acorn. They probably haven't a clue either.
  126.  
  127.  
  128. Compatibility
  129. -------------
  130. This application has been tested on the author's A5000, but due to the lack
  131. of friends with Acorns has not been tested on other systems.
  132.  
  133.  
  134. Disclaimer
  135. ----------
  136. The author accepts no responsibility for any problems which this application
  137. may cause or loss of data resulting in its use. This application is Public
  138. Domain freeware. This means that it may be distributed, so long as no charge
  139. other than copying costs are charged for it.
  140.  
  141.  
  142. Contact
  143. -------
  144. Any comments, queries, donations or bug reports can be sent to Justin
  145. Fletcher at :
  146.  
  147. E-Mail : Gerph@essex.ac.uk
  148. URL    : http://users.essex.ac.uk/users/gerph
  149. IRC    : On #Acorn as Gerph
  150. Finger : finger jrflet@postman.essex.ac.uk
  151. Tel    : (01842) 813979
  152.  
  153. Snail Mail :
  154.     Justin Fletcher
  155.     “Galadriel”
  156.     17b Cromwell Road,
  157.     Weeting,
  158.     Brandon,
  159.     Suffolk.
  160.     IP27 0QT
  161.  
  162.  
  163. History
  164. -------
  165. Version 1.00 : ?? ??? ????
  166.                Written by those interesting people at Acorn
  167. Version 1.14 : 18 Dec 1990 ?
  168.                Well, that's the date on the original Acorn !Help file (which
  169.                was so naff, I just binned it and started again.
  170.  
  171. Version 1.50 : Sometime 1994
  172.                I began hacking about on a nice 3010 and added the lovelly
  173.                Create menu, plus some changes to make Fonts work with
  174.                indirection.
  175.  
  176. Version 1.51 : A little later, about December, maybe
  177.                I got an A5000 :-) Much hacking produced a version which allowed                you to fiddle with icons in most ways and your actions would
  178.                be carried out, along with any others which might be needed
  179.                (eg adding an 'allow keys' entry requires you to specify
  180.                indirected). Around this time the lovelly linked icons came
  181.                into being.
  182.  
  183. Version 1.52 : January, February... I dunno...
  184.                Hacking a bit with the linking, added a dialogue box (Shift
  185.                click on Amend) but it's VERY flakey. Broke the lovelly add an
  186.                indirection bit if you start messing around.
  187.  
  188. Version 1.55 : Somewhere inbetween then and now
  189.                (Honest, I'm not making these up, that's when I think I did
  190.                these hacks)
  191.                Added the extra options to the Window menu from the OSLib
  192.                headers.
  193.                
  194. Version 1.56 : 30 Mar 1996 (Yes ! A real date !)
  195.                Changed the templates to look a bit more up to date, and FIXED
  196.                the auto-indirection bit of code (Thanks Chris). Put off
  197.                adding External Edits.
  198.  
  199. Version 1.57 : 31 Mar 1996
  200.                Finally got around to adding External Edits. Yucky horrible
  201.                things that they are. Had a REAL look at the code. So much in
  202.                it is redundant, but I really don't want to fiddle /too/ much
  203.                with it.
  204.  
  205. Version 1.58 : 01 Sep 1996
  206.                Minor changes to make linking work when you renumber icons.
  207.                The list of linked icons should also work now.
  208.